Skip to content

main updates#71

Closed
dianalauragarcia wants to merge 38 commits intoads-api_updates_analyticsfrom
main
Closed

main updates#71
dianalauragarcia wants to merge 38 commits intoads-api_updates_analyticsfrom
main

Conversation

@dianalauragarcia
Copy link
Copy Markdown
Collaborator

No description provided.

tcaldwell-x and others added 30 commits April 13, 2026 16:25
Mintlify-Source: dashboard-editor
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
- Add full credit consumption table to pricing.mdx (read and write operations)
- Add Owned Read section: $0.001/resource for 12 self-data endpoints
- Add enterprise-only warnings on follow, unfollow, like, unlike endpoints
- Add quote-post enterprise-only warning on create-post endpoint
- Update sliders.js cost estimator dropdown with Owned Read pricing,
  enterprise-only indicators, and URL post pricing note
- Escape dollar signs as &dollar; to prevent LaTeX rendering in MDX
- Add Firehose Streams to intro alongside existing endpoints
- Add Firehose, Sample (1%), and Sample10 (Decahose) to backfill table
- Add Firehose curl examples for backfill and recovery sections
- Document firehose partition-based redundancy (up to 20 connections)
- Note that 1% Sample Stream does not support recovery
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
Signed-off-by: tcaldwell-x <tcaldwell@twitter.com>
- Comprehensive llms.txt system: root index + high-quality nested indexes
  (x-api/, enterprise-api/, x-ads-api/, xdks/python + typescript)
- New AGENTS.md and AGENT.md with explicit guidance for AI agents,
  Cursor, Grok, Claude, Windsurf, etc.
- Split 357k Campaign Management monolith into focused 80k Overview +
  dedicated API Reference page (plus navigation + link fixes)
- Added rich, accurate description: frontmatter to 500+ pages
  (huge improvement to llms.txt usefulness and scorer Freshness/Parity)
- Fixed 70+ frontmatter parsing errors (mostly migrate/integrate guides)
  so mintlify dev runs cleanly again
- Removed duplicate legacy GNIP/enterprise content under enterprise-api/
  (exact copies of x-api/ versions)
- Numerous CodeGroup, Tab, self-closing tag, and link repairs for parser
  compatibility and agent parsing

These changes directly address the Mintlify AFDocs agent scorer issues
(LLMS TXT Valid/Size/Freshness, Markdown Content Parity, Page Size)
and make docs.x.com dramatically more reliable and effective for
LLMs and autonomous agents.
tcaldwell-x and others added 6 commits May 4, 2026 20:24
…ctionary + final polish)

- Split x-api/fundamentals/data-dictionary.mdx (125k → clean overview + dedicated reference)
- Split x-ads-api/audiences.mdx (97k → 32k overview + 65k reference)
- Added rich descriptions to Powerstream, Volume/Compliance Streams, XDK reference modules
- Added smart client-side anchor redirect scripts on Audiences and Data Dictionary overviews (preserves old deep links)
- Fixed frontmatter/import parsing issues from the splits
- Updated docs.json navigation for all new reference pages
- Bulk link fixes across the repo for moved anchors
- Final regeneration of x-api/, enterprise-api/, x-ads-api/ llms.txt with all latest descriptions

This continues the agent-scorer work: Page Size (multiple large pages split), LLMS TXT Freshness/Valid (richer indexes), link safety (redirects + scripts), and overall agent usability.

All changes keep mintlify dev working cleanly.
… splits

- Removed inline JavaScript redirect scripts from the four split overview pages:
  - x-ads-api/campaign-management.mdx
  - x-ads-api/creatives.mdx
  - x-ads-api/audiences.mdx
  - x-api/fundamentals/data-dictionary.mdx

- Also cleaned a duplicate frontmatter block in creatives.mdx that was breaking the import statement

These were triggering 'Could not parse expression with acorn' / 'Could not parse import/exports with acorn' errors on `mintlify dev`.

The helpful <Note> components pointing to the new /reference pages remain in place and continue to guide both humans and agents.

All previous agent-scorer improvements (large page splits, 500+ rich descriptions, llms.txt architecture, AGENTS.md, permanent redirects, etc.) are fully preserved. The documentation site now builds and runs cleanly again.
- Grouped split sections for clarity:
  - Audiences (Overview + API Reference)
  - Creatives (Overview + API Reference)
  - Data Dictionary (Overview + Reference)
  - Campaign Management (already grouped)

- Standardized sidebarTitles:
  - All main landing pages now use 'Overview' inside their logical group
  - Deep reference pages use 'API Reference' (Ads) or 'Reference' (Data Dictionary)

- Added relevant icons to the new groups (users, image, target, book-open) for better visual scanning

- Updated Data Dictionary main page sidebarTitle to 'Overview' for consistency

This makes the sidebar much more intuitive and predictable after the recent large page splits (Campaign Management, Creatives, Audiences, Data Dictionary). Improves agent parsing of the documentation structure and overall Content Structure signal for the Mintlify agent scorer.
…ons and groups

- Converted every flat entry under the Resources section into its own group with a relevant icon:
  - Tools & Libraries (screwdriver-wrench)
  - Analytics (chart-line)
  - Audiences (users)
  - Campaign Management (target)
  - Catalog Management (book)
  - Creatives (image)

This eliminates visual inconsistency where only some groups had icons (which was making Campaign Management appear indented and the sidebar look unbalanced).

All groups now have uniform icon + header alignment. Longer group names like 'Campaign Management' and 'Catalog Management' will render cleanly without looking indented.

Improves overall sidebar professionalism and scannability for both humans and agents.
- Changed icon from 'target' to 'megaphone' for the Campaign Management group in the Ads Resources section.

The 'target' icon was rendering too small/thin (especially with the long group name), making Campaign Management appear indented or icon-less compared to Audiences and Creatives.

'megaphone' renders clearly, has strong visual weight, and is thematically perfect for advertising campaigns. All six top-level groups under Resources now have consistent, visible icons with perfect alignment.

This completes the sidebar polish for the split pages (Audiences, Creatives, Campaign Management, Data Dictionary) so everything looks balanced and professional.
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 5, 2026

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 3 committers have signed the CLA.

✅ tcaldwell-x
❌ actions-user
❌ mintlify[bot]
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants